<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" >

  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/turbolinks/5.2.0/turbolinks.js" integrity="sha256-iM4Yzi/zLj/IshPWMC1IluRxTtRjMqjPGd97TZ9yYpU=" crossorigin="anonymous"></script>
  <link href="https://fonts.googleapis.com/css?family=Roboto+Mono" rel="stylesheet">
  <link href="https://fonts.googleapis.com/css?family=Cousine|Inconsolata" rel="stylesheet">
  <link rel="shortcut icon" type="image/png" href="/favicon.png">

  <link rel="stylesheet" href="/css/style.css">
  <link rel="stylesheet" href="/css/css/fontawesome-all.min.css">
  <link rel="stylesheet" href="/css/css/work-sans-v7.css">
  <script src="/js/main.js"></script>

  <!-- Begin Jekyll SEO tag v2.6.1 -->
<title>Transaction Status Api | Hive Developer</title>
<meta name="generator" content="Jekyll v4.0.0" />
<meta property="og:title" content="Transaction Status Api" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Methods: find_transaction This API is intended to evaluate a transaction status after calling condenser_api.broadcast_transaction. To enable this API for steemd, the following is required in config.ini by specifying: plugin = transaction_status_api See: #3060 Since: The Mysterious Future Related transaction_status_api.find_transaction Returns the status of a given transaction id. Parameters: trx_id:string; expiration:timestamp (optional) The result will contain one of the following status values: Status Meaning unknown Expiration time in future, transaction not included in block or mempool within_mempool Transaction in mempool within_reversible_block Transaction has been included in block, block not irreversible within_irreversible_block Transaction has been included in block, block is irreversible expired_reversible Transaction has expired, transaction is not irreversible (transaction could be in a fork) expired_irreversible Transaction has expired, transaction is irreversible (transaction cannot be in a fork) too_old Transaction is too old, I don’t know about it Query Parameters JSON { &quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;: &quot;2016-03-24T18:00:21&quot; } Expected Response JSON {&quot;status&quot;: &quot;unknown&quot;} Example curl curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;:&quot;2016-03-24T18:00:21&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network" />
<meta property="og:description" content="Methods: find_transaction This API is intended to evaluate a transaction status after calling condenser_api.broadcast_transaction. To enable this API for steemd, the following is required in config.ini by specifying: plugin = transaction_status_api See: #3060 Since: The Mysterious Future Related transaction_status_api.find_transaction Returns the status of a given transaction id. Parameters: trx_id:string; expiration:timestamp (optional) The result will contain one of the following status values: Status Meaning unknown Expiration time in future, transaction not included in block or mempool within_mempool Transaction in mempool within_reversible_block Transaction has been included in block, block not irreversible within_irreversible_block Transaction has been included in block, block is irreversible expired_reversible Transaction has expired, transaction is not irreversible (transaction could be in a fork) expired_irreversible Transaction has expired, transaction is irreversible (transaction cannot be in a fork) too_old Transaction is too old, I don’t know about it Query Parameters JSON { &quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;: &quot;2016-03-24T18:00:21&quot; } Expected Response JSON {&quot;status&quot;: &quot;unknown&quot;} Example curl curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;:&quot;2016-03-24T18:00:21&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network" />
<link rel="canonical" href=".#apidefinitions-transaction-status-api" />
<meta property="og:url" content=".#apidefinitions-transaction-status-api" />
<meta property="og:site_name" content="Hive Developer" />
<meta property="og:type" content="article" />
<meta property="article:published_time" content="2020-08-26T11:52:22-07:00" />
<script type="application/ld+json">
{"description":"Methods: find_transaction This API is intended to evaluate a transaction status after calling condenser_api.broadcast_transaction. To enable this API for steemd, the following is required in config.ini by specifying: plugin = transaction_status_api See: #3060 Since: The Mysterious Future Related transaction_status_api.find_transaction Returns the status of a given transaction id. Parameters: trx_id:string; expiration:timestamp (optional) The result will contain one of the following status values: Status Meaning unknown Expiration time in future, transaction not included in block or mempool within_mempool Transaction in mempool within_reversible_block Transaction has been included in block, block not irreversible within_irreversible_block Transaction has been included in block, block is irreversible expired_reversible Transaction has expired, transaction is not irreversible (transaction could be in a fork) expired_irreversible Transaction has expired, transaction is irreversible (transaction cannot be in a fork) too_old Transaction is too old, I don’t know about it Query Parameters JSON { &quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;: &quot;2016-03-24T18:00:21&quot; } Expected Response JSON {&quot;status&quot;: &quot;unknown&quot;} Example curl curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network curl -s --data &#39;{&quot;jsonrpc&quot;:&quot;2.0&quot;, &quot;method&quot;:&quot;transaction_status_api.find_transaction&quot;, &quot;params&quot;: {&quot;transaction_id&quot;: &quot;0000000000000000000000000000000000000000&quot;, &quot;expiration&quot;:&quot;2016-03-24T18:00:21&quot;}, &quot;id&quot;:1}&#39; https://api.openhive.network","mainEntityOfPage":{"@type":"WebPage","@id":".#apidefinitions-transaction-status-api"},"@type":"BlogPosting","url":".#apidefinitions-transaction-status-api","headline":"Transaction Status Api","dateModified":"2020-08-26T11:52:22-07:00","datePublished":"2020-08-26T11:52:22-07:00","@context":"https://schema.org"}</script>
<!-- End Jekyll SEO tag -->


  
</head>
<body>
<header>
  <h1>
    <button type="button" class="open-nav" id="open-nav"></button>
    <a href="/"  class="logo-link"><img src="/images/logotype_black.svg" height="40" alt="Hive Developer logo"></a>
  </h1>

  
  <form action="/search/" method="get">
    <input type="text" name="q" id="search-input" placeholder="Search">
    <input type="submit" value="Search" style="display: none;">
  </form>
  

  <div id="sidebar" class="sidebar">
	
	
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/">
		<h6 class="ctrl-nav-section title">Introduction</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/#introduction-welcome">Welcome to Hive</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/quickstart/">
		<h6 class="ctrl-nav-section title">Quickstart</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/quickstart/#quickstart-choose-library">Choose Library</a></li>
						
					
						
						<li><a href="/quickstart/#quickstart-hive-full-nodes">Hive Nodes</a></li>
						
					
						
						<li><a href="/quickstart/#quickstart-testnet">Hive Testnet</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/tutorials/">
		<h6 class="ctrl-nav-section title">Tutorials</h6>
		<ul class="cont-nav-section content">
			
				
					
						<li><a href="/tutorials/#tutorials-javascript">Javascript</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-python">Python</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-ruby">Ruby</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-recipes">Recipes</a></li>
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/services/">
		<h6 class="ctrl-nav-section title">Services</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/services/#services-hive-blog">hive.blog</a></li>
						
					
						
						<li><a href="/services/#services-hivesigner">HiveSigner</a></li>
						
					
						
						<li><a href="/services/#services-jussi">Jussi</a></li>
						
					
						
						<li><a href="/services/#services-imagehoster">ImageHoster</a></li>
						
					
						
						<li><a href="/services/#services-dhf">DHF</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/apidefinitions/">
		<h6 class="ctrl-nav-section title">Appbase API</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/apidefinitions/#apidefinitions-condenser-api">Condenser Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-bridge">Bridge</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-account-by-key-api">Account By Key Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-account-history-api">Account History Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-block-api">Block Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-database-api">Database Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-debug-node-api">Debug Node Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-follow-api">Follow Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-jsonrpc">Jsonrpc</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-market-history-api">Market History Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-network-broadcast-api">Network Broadcast Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-rc-api">Rc Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-reputation-api">Reputation Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-rewards-api">Rewards Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-tags-api">Tags Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-transaction-status-api">Transaction Status Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-witness-api">Witness Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-broadcast-ops">Broadcast Ops</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-broadcast-ops-communities">Broadcast Ops Communities</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/resources/">
		<h6 class="ctrl-nav-section title">Resources</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/resources/#resources-overview">Overview</a></li>
						
					
						
						<li><a href="/resources/#resources-client-libs">Client Libraries</a></li>
						
					
						
						<li><a href="/resources/#resources-bluepaper">Bluepaper</a></li>
						
					
						
						<li><a href="/resources/#resources-whitepaper">Whitepaper</a></li>
						
					
						
						<li><a href="/resources/#resources-tools">Tools</a></li>
						
					
						
						<li><a href="/resources/#resources-hivesigner-libs">Hivesigner Libs</a></li>
						
					
						
						<li><a href="/resources/#resources-hive-keychain">Hive Keychain</a></li>
						
					
						
						<li><a href="/resources/#resources-developeradvocate">Community & Help</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/glossary/">
		<h6 class="ctrl-nav-section title">Glossary</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/glossary/#glossary-chain-basics">Chain Basics</a></li>
						
					
						
					
						
						<li><a href="/glossary/#glossary-governance">Governance</a></li>
						
					
						
						<li><a href="/glossary/#glossary-transactions">Transactions</a></li>
						
					
						
						<li><a href="/glossary/#glossary-api">API</a></li>
						
					
						
						<li><a href="/glossary/#glossary-market">Market</a></li>
						
					
				
			
		</ul>
	</section>
	
</div>



  <link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet">
</header>
<div class="main" id="top">
  <div class="hero">
    <h1 class="hero__h1">Hive Developer Portal </h1>
    <img class="hero__img" src="/images/honey-comb-92.png" style="position: relative; top: 10px;" />
  </div>
  <p>Methods:</p>
<ul>



<li class="button"><a href="#transaction_status_api.find_transaction">find_transaction</a></li>


</ul>

<p>This API is intended to evaluate a transaction status after calling <a href="/apidefinitions/#condenser_api.broadcast_transaction"><code class="highlighter-rouge">condenser_api.broadcast_transaction</code></a>.</p>

<p>To enable this API for <code class="highlighter-rouge">steemd</code>, the following is required in <code class="highlighter-rouge">config.ini</code> by specifying:</p>

<div class="language-ini highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="py">plugin</span> <span class="p">=</span> <span class="s">transaction_status_api</span>
</code></pre></div></div>

<p>See: <a href="https://github.com/steemit/steem/pull/3060">#3060</a></p>

<ul style="float: right; list-style: none;">

<li class="success"><strong><small>Since: The Mysterious Future</small></strong></li>





<li class="info"><strong><small><a href="/search/?q=find%20transaction">Related <i class="fas fa-search fa-xs"></i></a></small></strong></li>

</ul>
<h4 id="transaction_status_api.find_transaction">transaction_status_api.find_transaction <a href="#transaction_status_api.find_transaction"><i class="fas fa-link fa-xs"></i></a></h4>
<p>Returns the status of a given transaction id.  Parameters: <code class="highlighter-rouge">trx_id:string</code>; <code class="highlighter-rouge">expiration:timestamp</code> (optional)</p>

<p>The result will contain one of the following <code class="highlighter-rouge">status</code> values:</p>

<table>
  <thead>
    <tr>
      <th>Status</th>
      <th>Meaning</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="highlighter-rouge">unknown</code></td>
      <td>Expiration time in future, transaction not included in block or mempool</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">within_mempool</code></td>
      <td>Transaction in mempool</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">within_reversible_block</code></td>
      <td>Transaction has been included in block, block not irreversible</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">within_irreversible_block</code></td>
      <td>Transaction has been included in block, block is irreversible</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">expired_reversible</code></td>
      <td>Transaction has expired, transaction is not irreversible (transaction could be in a fork)</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">expired_irreversible</code></td>
      <td>Transaction has expired, transaction is irreversible (transaction cannot be in a fork)</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">too_old</code></td>
      <td>Transaction is too old, I don’t know about it</td>
    </tr>
  </tbody>
</table>

<h5 id="transaction_status_api.find_transaction-parameter_json">Query Parameters JSON <a href="#transaction_status_api.find_transaction-parameter_json"><i class="fas fa-link fa-sm"></i></a></h5>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"transaction_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
  </span><span class="nl">"expiration"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2016-03-24T18:00:21"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
<h5 id="transaction_status_api.find_transaction-expected_response_json">Expected Response JSON <a href="#transaction_status_api.find_transaction-expected_response_json"><i class="fas fa-link fa-sm"></i></a></h5>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="nl">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown"</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<h5 id="transaction_status_api.find_transaction-curl-examples">Example <code>curl</code> <a href="#transaction_status_api.find_transaction-curl-examples"><i class="fas fa-link fa-sm"></i></a></h5>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000"}, "id":1}'</span> https://api.openhive.network
</code></pre></div></div>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000", "expiration":"2016-03-24T18:00:21"}, "id":1}'</span> https://api.openhive.network
</code></pre></div></div>

<hr />


</div>
<div class="footer">
  <a href="#">Back to top</a>
</div>
<script>
    document.getElementById("open-nav").addEventListener("click", function () {
        document.body.classList.toggle("nav-open");
    });
</script>
</body>
</html>


<script src="/js/adjust.js"></script>

